home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / hypertxt / msdos / hs25 / msdos.hyp < prev    next >
Text File  |  1989-05-07  |  26KB  |  997 lines

  1. .REMARK
  2. MSDOS Hyperfile copyright (c) N.G.Taylor 1989
  3. .
  4. .HEADER
  5.  $1 - $2   ~C65~NMSDOS~E
  6. ═════════════════════════════════════════════════════════════════════════════
  7. .
  8.  
  9. .FOOTER
  10. ~L20═════════════════════════════════════════════════════════════════════════════
  11. ~MGeneral~E   ~MDisk~E   ~MDirectories~E   ~MFiles~E   ~MScreen~E   ~MPrinter~E   ~MBatch~E    ~ADOS Terms~PN@MDOS Terms~E
  12. .
  13. .CHECK +fa
  14.  
  15. .
  16. .MENU Disk
  17. ASSIGN
  18. CHKDSK
  19. DISKCOMP
  20. DISKCOPY
  21. FORMAT
  22. LABEL
  23. SYS
  24. VERIFY
  25. VOL
  26. .
  27.  
  28. .MENU General
  29. BREAK
  30. DATE
  31. KEYBUK
  32. PATH
  33. PROMPT
  34. SET
  35. TIME
  36. VER
  37. .
  38. .MENU Screen
  39. CLS
  40. CTTY
  41. MODE
  42. .
  43.  
  44. .MENU Printer
  45. GRAPHICS
  46. PRINT
  47. .
  48.  
  49. .MENU Directories
  50. CHDIR
  51. DIR
  52. JOIN
  53. MKDIR
  54. RMDIR
  55. SUBST
  56. TREE
  57. XCOPY
  58. .
  59.  
  60. .MENU Files
  61. APPEND
  62. ATTRIB
  63. COMP
  64. COPY
  65. DEL
  66. EDLIN
  67. ERASE
  68. FIND
  69. MORE
  70. RENAME
  71. REPLACE
  72. SORT
  73. TYPE
  74. .
  75.  
  76. .MENU Batch
  77. ECHO
  78. IF
  79. GOTO
  80. FOR
  81. PAUSE
  82. REM
  83. Parameter
  84. SHIFT
  85. .
  86.  
  87. .CHECK -fa
  88.  
  89. .
  90. .MENU DOS Terms
  91. Environment variable
  92. ASCII
  93. Internal command
  94. External command
  95. Filespec
  96. Wildcard
  97. Subdirectory
  98. Root directory
  99. Default directory
  100. Default drive
  101. Status code
  102. Filter
  103. .
  104. .NOTE Help
  105. LEFT Mouse button is used for
  106.      selection of item.
  107. RIGHT button is used to select
  108.      control menu
  109. Items are other frames
  110.           notes
  111.           menus
  112. .
  113.  
  114. .NOTE Filespec
  115.  
  116. This should take the form
  117.  
  118. [d:][\][path\][filename.filetype]
  119.  
  120. Where filename can be up to 8
  121. characters and filetype can be up
  122. to 3 characters.
  123. .
  124.  
  125. .NOTE MSDOS
  126. This document describes the commands
  127. available under MSDOS version 3.2
  128. .
  129.  
  130. .NOTE Filter
  131. A filter is a program which reads from
  132. its standard input and writes to its
  133. standard output. Input and output can
  134. be redirected to/from a file or piped
  135. to/from another program. e.g.
  136.  
  137. FILTERPROG < INPUT.FIL > OUTPUT.FIL
  138.  
  139. PROGRAM1 | FILTERPROG | PROGRAM2
  140. .
  141. .NOTE Status Code
  142. Sometimes referred to as the exit code
  143. this code is the value returned to DOS
  144. by a program when it terminates. It may
  145. be tested using the batch ~FIF~E command.
  146. The success status is normally 0.
  147. .
  148. .NOTE Root directory
  149. The Root directory is the highest level
  150. directory in the directory structure on
  151. a disk. The pathname symbol '\' at the
  152. start of a pathname indicates the root
  153. node in the hierarchy, the rest of the
  154. pathname being relative to this.
  155. .
  156. .NOTE Subdirectory
  157. A subdirectory is one which is held
  158. within another directory. A structure
  159. of directories can exist to any level.
  160. .
  161. .NOTE Internal command
  162. An internal command is one which is
  163. built into the DOS command processor
  164. and does not reside as a file on
  165. the disk.
  166. .
  167. .NOTE External command
  168. An external command is one which
  169. resides as a program file on the
  170. disk. It is held in a file with
  171. the extension of .EXE or .COM
  172.  
  173. .
  174. .NOTE ASCII
  175. ASCII is an abbreviation for the
  176. code used to store textual data
  177. on a computer:- American Standard
  178. Code for Information Interchange
  179. .
  180. .NOTE Default Directory
  181.  The current directory which will be
  182.  used to refer to programs and files
  183.  if a direct pathname to the file is
  184.  not given. Other directories may be
  185.  searched for files using the ~FPATH~E
  186.  and ~FAPPEND~E commands to specify a
  187.  search path.
  188. .
  189. .NOTE Default Drive
  190.  The current disk drive which is used
  191.  for all file specifications which do
  192.  not include a drive specification in
  193.  their pathname. The default drive is
  194.  indicated on the DOS command line in
  195.  the prompt.
  196. .
  197. .NOTE Wildcard
  198.  A wildcard file specification allows
  199.  all files matching a pattern to be
  200.  selected. The '*' wildcard matches
  201.  any number of characters in a file
  202.  name or extension. The '?' wildcard
  203.  matches any single character. e.g.
  204.  
  205.  *.EXE    - all programs
  206.  *.H??    - all HyperShell data files
  207. .
  208. .NOTE Environment variable
  209.  An environment variable is a
  210.  variable used by programs and
  211.  batch files, set up using the
  212.  ~FSET~E command.
  213. .
  214.  
  215. .INDEX
  216. indicate that index is required
  217.  
  218. .REMARK
  219. Start of main frame area
  220. .FRAME APPEND
  221. .TITLE Set a search path for data files
  222.     APPEND [d:]\path[;[d:]\path..]
  223.  
  224.     This sets up a sequence of pathnames that are searched for data
  225.     files when the data file is not in the ~Ndefault directory~E.
  226. .
  227. .END
  228.  
  229. .FRAME ASSIGN
  230. .TITLE Assign drive letter to another drive
  231.     ASSIGN requested-drive=searched-drive
  232.  
  233.     ASSIGN instructs DOS to use a disk drive other than
  234.     the one specified in a file operation.
  235.  
  236. e.g.    ASSIGN A=C
  237.  
  238.     This will cause all references to A: to use drive C: instead
  239. .
  240. .END
  241.  
  242. .FRAME ATTRIB
  243. .TITLE Set file attributes
  244.     ATTRIB [+R or -R] [+A or -A] [d:][\][path\]filename.filetype
  245.  
  246.     OPTIONS
  247.     -------
  248.     +R   Make the file Read-Only.
  249.     -R   Make the file Read-Write again.
  250.     +A   Force the file to be backed-up even if it has not been changed.
  251.     -A   Stop the file from being backed-up even though it has been changed.
  252.  
  253.     ~NWildcard~E file specifications can be used.
  254. .
  255. .FRAME BREAK
  256. .TITLE Set break level
  257.     BREAK ON or BREAK OFF
  258.  
  259.     ON  -  check for Ctrl Break on every DOS operation
  260.  
  261.     OFF -  check for Ctrl Break only during a screen, keyboard,
  262.            printer or comms operation
  263.  
  264.     No parameter - show current setting
  265. .
  266. .FRAME CHDIR
  267. .TITLE Change to new directory for drive
  268.     CHDIR [d:][\]path
  269.  
  270.     CD [d:][\]path
  271.  
  272.     CHDIR changes the ~Ndefault directory~E associated with the
  273.     ~Ndefault drive~E or a named drive.
  274.  
  275.     If used without parameters, the ~Ndefault directory~E is displayed.
  276.  
  277. .
  278. .END
  279.  
  280. .FRAME CHKDSK
  281. .TITLE Carry out disk and memory check
  282.     CHKDSK d:[\][path\][filename.filetype][/F][/N]
  283.  
  284.     OPTIONS
  285.     -------
  286.     /F   Fix errors as the disk is processed.
  287.     /N   Display messages as the disk is processed.
  288.  
  289.     CHKDSK performs checks on the memory in the PC and on the
  290.     directories in the specified (or default) drive. Any filenames
  291.     specified are checked for non-contiguous sectors.
  292.  
  293.     ~NWildcard~E characters can be used for the file specification.
  294.  
  295. .
  296. .FRAME CLS
  297. .TITLE Clear screen
  298.     CLS
  299.  
  300.     CLS clears the screen display.
  301.  
  302.     This is a DOS ~Ninternal command~E
  303. .
  304. .FRAME COMP
  305. .TITLE Compare two files
  306.     COMP [option[option...]] [d:][\][path\]filename.filetype [d:][\][path\]
  307.          filename.filetype
  308.  
  309.     OPTIONS
  310.     -------
  311.     ~n/A~E ~n/C~E ~n/L~E ~n/LBn~E ~n/N~E ~n/T~E ~n/W~E ~n/n~Pnnumber~E
  312.  
  313.     COMP compares two files and reports on any differences.
  314.     It can also be used to compare sets of files.
  315.  
  316.     ~NWildcard~E characters are allowed in the file specifications.
  317.  
  318.     When differences are found, the offset in the file, and the
  319.     contents in each file, are displayed. A count of the differences
  320.     is reported at the end of processing.
  321. .
  322. .NOTE /A
  323. To indicate where the difference
  324. is just display the last line of
  325. the previous matching section and
  326. the first line of the following
  327. matching section - not all the
  328. lines in between. (The lines in
  329. between are represented by ...).
  330. .NOTE /C
  331. Treat all letters as upper case
  332. in the comparison.
  333. .NOTE /L
  334. Force a line by line comparison.
  335. (Used when the filetype of either
  336. file is EXE, COM, SYS, OBJ, LIB
  337. or BIN.)
  338. .NOTE /LBn
  339. Set the buffer size to n lines.
  340. (The default is 100 lines; the
  341. maximum depends on the amount
  342. of memory space your PC has.)
  343. .NOTE /N
  344. Add line numbers when reporting
  345. where the differences are.
  346. .NOTE /T
  347. Don't expand tab characters to
  348. spaces. (The default is to interpret
  349. each tab character as spaces up to
  350. the start of the next 8 character
  351. column.
  352. .NOTE /W
  353. Interpret all tabs and multiple
  354. spaces as single spaces; ignore
  355. spaces at the beginning and end
  356. of any line.
  357. .NOTE number
  358. Set the number of identical lines
  359. required before the comparison
  360. resynchronises to n. (The default
  361. is 2 lines).
  362. .END
  363. .FRAME COPY
  364. .TITLE Copy files
  365.     COPY [d:][\][path\]source[/A][/B] [d:][\][path\]destination[/A][/B][/V]
  366.  
  367.     OPTIONS
  368.     -------
  369.     SOURCE
  370.     /A  The file is treated as an ~NASCII~E text file. The contents are copied
  371.         up to, but not including, the first Ctrl-Z (end of file) character. The
  372.     /B  The entire file is copied, regardless of any Ctrl-Z (end of file)
  373.         character found in the file.
  374.  
  375.     DESTINATION
  376.     /A  The file is treated as an ~NASCII~E text file. A Ctrl-Z (end of file)
  377.         character is added to the end of the file.
  378.     /B  No Ctrl-Z (end of file) character is added to the end of the file.
  379.     /V  The destination file is compared with the source file to verify
  380.         the accuracy of the copy.
  381.  
  382.     ~NWildcard~E characters may be used in the source file specification.
  383. .
  384. .FRAME CTTY
  385. .TITLE Change default console device
  386.     CTTY device
  387.  
  388.     CTTY redirects the standard console interaction to an
  389.     auxiliary device. The device may be one of AUX, COM1,
  390.     COM2 or CON. CON is the default console device, and
  391.     setting to this has the effect of resetting the console
  392.     to keyboard and screen.
  393.  
  394.     CTTY is a DOS ~Ninternal command~E.
  395. .
  396. .FRAME DATE
  397. .TITLE Show or set date
  398.     DATE [dd-mm-yy]
  399.  
  400.     DATE displays and optionally sets the system date
  401.  
  402.     DATE is a DOS ~Ninternal command~E.
  403. .
  404. .FRAME DEL
  405. .TITLE Delete file(s)
  406.     DEL [d:][\][path\]filename.filetype
  407.  
  408.     DEL erases files from disk on the specified drive in the
  409.     specified directory.
  410.  
  411.     ~NWildcard~E file specifications are permitted. If all files are
  412.     specified with a *.* wildcard, the confirmatory prompt:-
  413.  
  414.     Are you sure(Y/N)
  415.  
  416.     Is issued before doing the deletion.
  417.  
  418.     DEL is a short form of the ERASE command, and is a
  419.     DOS ~Ninternal command~E.
  420. .
  421. .FRAME DIR
  422. .TITLE List (matching) file names
  423.     DIR [d:][\][path\][filename.filetype][/P][/W]
  424.  
  425.     Display a directory listing of files in the specified directory,
  426.     or default directory if no directory specified.
  427.  
  428.     OPTIONS
  429.     -------
  430.     /P  The display pauses after every screenful of information.
  431.         Press any key to see the next screenful.
  432.  
  433.     /W  Just the filenames and filetypes, with 5 files on each line.
  434.  
  435.     ~NWildcard~E file specifications may be used with DIR.
  436. .
  437. .FRAME DISKCOMP
  438. .TITLE Compare disks
  439.     DISKCOMP source-drive: target-drive:[/1][/8]
  440.  
  441.     OPTIONS
  442.     -------
  443.     /1   Compare just the first side of the disks.
  444.     /8   Compare just the first eight sectors of each track.
  445.  
  446.     DISKCOMP compares two disks to verify that they are identical.
  447.     If any differences are found, the track number and side are
  448.     reported.
  449. .
  450. .FRAME DISKCOPY
  451. .TITLE Copy entire disk
  452.     DISKCOPY source-drive: target-drive:
  453.  
  454.     OPTIONS
  455.     -------
  456.     /1  - only copy the first side, even if double sided.
  457.  
  458.     DISKCOPY copies the contents of a floppy disk from one
  459.     drive to another.
  460. .
  461. .FRAME EDLIN
  462. .TITLE Line editor
  463.     EDLIN [d:][\][path\]filename.filetype[/B]
  464.  
  465.     OPTIONS
  466.     -------
  467.     /B   Don't interpret Ctrl-Z characters as end of file.
  468.  
  469.     EDLIN invokes the MSDOS line editor to edit the specified
  470.     file.
  471.  
  472.     EDLIN commands are detailed in ~FEDLIN COMMANDS~E.
  473. .
  474. .FRAME EDLIN COMMANDS
  475. .TITLE Commands used within EDLIN
  476.     EDLIN Commands are as follows:-
  477.     n        edit line n
  478.     [n]A        append n lines
  479.     [n],[m],l[,c]C    Copy a range of lines
  480.     [n][,m]D    Delete a range of lines
  481.     E        End edit, save file, return to DOS
  482.     [n]I        Insert lines before line n
  483.     [n][,m]L    List range of lines
  484.     [n][,m]lM    Move range of lines
  485.     [n][,m]P    Display range of lines in pages
  486.     Q        Quit to DOS without saving    
  487.     [n][,m][?]Rold-string[Ctrl-Z[newstring]] Replace all old with new
  488.     [n][,m][?]Sstring    Search for string in range
  489.     [l]Tfilespec    Transfer file into edit buffer before line l
  490.     [n]W        Write first n lines to disk
  491. .
  492. .FRAME ERASE
  493. .TITLE Delete file(s)
  494.     ERASE [d:][\][path\]filename.filetype
  495.  
  496.     This command is the same as the ~FDEL~E command (viz.).
  497.  
  498. .
  499. .FRAME FIND
  500. .TITLE Find text string in a file
  501.     FIND [/V][/C][/N] "string" [d:][\][path\]filename.filetype
  502.  
  503.     OPTIONS
  504.     -------
  505.     /V  Display all lines except those containing the specified string.
  506.     /C  Display the number of lines in which the string was found.
  507.     /N  Number of lines according to their position in the file.
  508.  
  509.     FIND reads the named file or files, or acts as a ~Nfilter~E if no
  510.     files are specified, searching its input for "string"
  511.     where "string" is an alphanumeric string specifying exact case
  512.     of letters.
  513.  
  514. e.g.    FIND "fred" NAME1.LST NAME2.LST
  515.  
  516.     ~FDIR~E | FIND "EXE"
  517.  
  518. .
  519. .FRAME FORMAT
  520. .TITLE Format Disk in specified drive
  521.     FORMAT d:[option[option...]]
  522.  
  523.     OPTIONS
  524.     -------
  525.     /1    Format a single sided disk.
  526.     /8    Format with 8 usable sectors per track.
  527.     /B    Reserve space for hidden system files.
  528.     /N:n  Format with n sectors per track (n=8,9)
  529.     /T:t  Format with t tracks (t=40,80)
  530.     /V    Prompt for a disk label after the format has been completed (the
  531.           label which is shown on the screen every time you use the DIR
  532.           command to display the contents of the disk - can be up to 11
  533.           characters long.
  534.     /S    Format and prepare for use as a startup disk by copying the
  535.           system files from the default drive to the newly formatted disk.
  536.  
  537. .
  538. .FRAME GRAPHICS
  539. .TITLE Set up graphics driver for printer
  540.     GRAPHICS printer-type[/R][/B]
  541.  
  542. ---------------------- PRINTER TYPES -------------------------
  543. COLOR1     IBM PC Color Printer (or compatible) with a black ribbon.
  544. COLOR4     IBM PC Color Printer (or compatible) with an RGB (Red, Green,
  545.            Blue) ribbon.
  546. COLOR8     IBM PC Color Printer (or compatible) with a CMY (Cyan,Magenta,
  547.            Yellow and Black) ribbon.
  548. COMPACT    IBM PC Compact Printer (or compatible).
  549. GRAPHICS   IBM PC Graphics Printer (or compatible, e.g AMSTRAD DMP3000).
  550. COLORJET   IBM Colorjet Printer (or compatible).
  551.  
  552. ----------------------- OPTIONS -------------------------------
  553. /R  Print foreground light, background dark as seen on the monitor.
  554.     If this option is not selected, then the foreground is printed
  555.     dark and the background light.
  556. /B  Print the background colour. If this option is not selected the
  557.     background colour is not printed. (PRINTER TYPES COLOR4 & 8 ONLY).
  558. /F  Turn the screen dump round through 90 Degrees.
  559. /C  Centre the screen dump on the page.
  560. .
  561. .FRAME JOIN
  562. .TITLE Join drive as directory
  563.     JOIN d: [d:][\]path
  564.  
  565.     JOIN d:/D
  566.  
  567.     JOIN joins a disk drive to a directory on another drive.
  568.  
  569.     The /D switch breaks any join so made
  570.  
  571.     The directory to be joined to must be empty, and must be in
  572.     the root directory. If it does not exist, it will be created.
  573.  
  574.     References to files beneath this directory will be referred
  575.     to the drive joined at that point.
  576.  
  577. .
  578. .FRAME KEYBUK
  579. .TITLE Set for british keyboard
  580.     KEYBUK
  581.  
  582.     This sets the keyboard up for U.K. usage
  583.  
  584.  
  585. .
  586. .FRAME LABEL
  587. .TITLE Label a disk
  588.     LABEL [d:] label
  589.  
  590.     LABEL creates, or changes, a disk label. The label
  591.     can be up to 11 characters long, including spaces.
  592.  
  593.     If no parameter is specified, the label is displayed.
  594.  
  595.     All characters except *?/\|.,;:+=<>[] can be used.
  596.  
  597. .
  598. .FRAME MKDIR
  599. .TITLE Create subdirectory
  600.     MKDIR [d:][\]path
  601.  
  602.     MKDIR creates a new subdirectory on the specified (or default)
  603.     drive and directory.
  604.  
  605.     MKDIR is a DOS ~Ninternal command~E
  606.  
  607.     See also ~FRMDIR~E
  608. .
  609. .FRAME MODE
  610. .TITLE Set device mode
  611.     MODE device:setting[,setting...]
  612.  
  613.     Sets up a device mode as follows:-
  614.  
  615.     MODE LPTn:w,v (n = 1,2,3:w = 80,132:v = 6,8) - set printer
  616.  
  617.     MODE [w],[s[,T]] (w = 40,80,BW40,BW80,CO40,CO80,MONO) - screen mode
  618.         (s = L,R)    - shift left/right one/two characters
  619.         (T)        - test pattern display for alignment
  620.  
  621.     MODE COMn:baud[,parity[,databits[,stopbits[,P]]]]
  622.         (n = 1,2:baud=110 to 9600:parity=N,E,O:databits=7,8)
  623.         (stopbits=1,2:P indicates printer) - set comms port
  624.  
  625.     MODE LPTn:=COMm (n=1,2,3:m=1,2) - redirect printer output to
  626.         serial port.
  627. .
  628. .FRAME MORE
  629. .TITLE Display output a screenful at a time
  630.     MORE < ~Nfilespec~E
  631.  
  632.     MORE is used to display a text file a page at a time. It is used
  633.     as a ~Nfilter~E, and has its input redirected or piped into it. When
  634.     each page is complete, the message "--More--" appears on the bottom
  635.     line and the program waits for a key to be pressed.
  636.  
  637. e.g.    ~FDIR~E | MORE
  638.  
  639.     to display a long directory listing a page at a time
  640.  
  641.     MORE < TEXT.FIL
  642.  
  643.     to display the file TEXT.FIL a page at a time
  644. .
  645. .END
  646.  
  647. .
  648. .FRAME PATH
  649. .TITLE Set search path for executables
  650.     PATH [d:]\path[;[d:]\path...]
  651.  
  652.     PATH specifies the list of directories searched when programs
  653.     or batch files are not in the default directory.
  654.  
  655.     If no parameters are specified, the current value is shown.
  656.  
  657.     PATH; clears the search path, so that only the default directory
  658.     is searched.
  659.  
  660.     PATH is a DOS ~Ninternal command~E
  661. .
  662. .FRAME PRINT
  663. .TITLE Spool file for printing
  664. PRINT [d:][\][path\]filename.filetype[[d:][\][path\]filename.filetype...]
  665.                                                              [\P][\C][\T]
  666.  
  667.     OPTIONS
  668.     -------
  669.     /C   Remove this and following files (up to the next file listed with
  670.          the P option) from the list of files waiting to be printed.
  671.     /P   Add this and following files (up to the next file listed with the
  672.          /C option) to the list of files waiting to be printed.
  673.     /T   Stop the current file from being printed.
  674.  
  675.     PRINT controls the print spooler, to enable files to be sent to
  676.     the printer as a background process whilst other work is done.
  677. .
  678. .END
  679. .FRAME PROMPT
  680. .TITLE Set prompt string
  681.     PROMPT prompt-text
  682.     where [prompt-text] is: letter:$$character[letter:$$character...]
  683.  
  684.     $$T   Time.
  685.     $$d   Date.
  686.     $$n   The drive letter of the default drive.
  687.     $$p   The current directory on the default drive.
  688.     $$v   The MS-DOS version number.
  689.     $$$$   A $$ character.
  690.     $$g   A ">" character.
  691.     $$l   A "<" character.
  692.     $$b   A : character.
  693.     $$q   A = character.
  694.     $$h   A Backspace character.
  695.     $$e   An ESCape character.
  696.     $$_   A new line.
  697.  
  698.     PROMPT sets the DOS prompt string.
  699. .
  700. .FRAME RENAME
  701. .TITLE Rename file
  702.     RENAME [d:][\][path\]old-name new-name
  703.  
  704.     Renames a file to a new name
  705.  
  706.     RENAME may be shortened to REN
  707.  
  708.     ~NWildcard~Es can be used in the filename or extension part
  709.     of the file specification to enable a set of files to be
  710.     renamed.
  711.  
  712.     RENAME is a DOS ~Ninternal command~E
  713. .
  714. .FRAME REPLACE
  715. .TITLE Replace old versions and add new
  716.     REPLACE source-drive:[\][path\]filename.filetype
  717.              target-drive:[\][path][option[option...]]
  718.  
  719.     OPTIONS
  720.     -------
  721.     /A   Add new files to the target directory.
  722.     /D   Replace only if the source file is more recent.
  723.     /P   Prompt for confirmation before replacing a target file or adding a
  724.          new source file.
  725.     /R   Search both the given target directory and its subdirectories for
  726.          old versions of the files.
  727.     /S   Replace both read-write and read-only files.
  728.     /w   Wait for a key to be pressed before starting replacing and adding
  729.          files.
  730.  
  731.     REPLACE updates a second directory with uptodate versions of files,
  732.     and adds new files. ~NWildcard~E file specifications may be used.
  733. .
  734. .FRAME RMDIR
  735. .TITLE Delete subdirectory
  736.     RMDIR [d:][\]path
  737.  
  738.     RMDIR removes a ~Nsubdirectory~E.
  739.  
  740.     RMDIR can be shortened to RD.
  741.  
  742.     The directory must be empty before it can be deleted.
  743.  
  744.     RMDIR is a DOS ~Ninternal command~E
  745. .
  746. .END
  747.  
  748.  
  749. .
  750. .FRAME SET
  751. .TITLE Set environment variable
  752.     SET variable=string
  753.  
  754.     SET inserts variables into the DOS environment list.
  755.     These are known as environment variables.
  756.  
  757.     If no parameters are specified, the current settings are
  758.     shown.
  759.  
  760.     If the 'string' parameter is null (e.g. 'SET variable=')
  761.     the variable is removed from the environment.
  762.  
  763.     This is a DOS ~Ninternal command~E
  764.  
  765. e.g.    SET NAME=FRED
  766. .
  767. .FRAME SORT
  768. .TITLE Sort file
  769.     SORT [/R][/+n]  [d:][\][path\]filename.filetype] [ destination]
  770.  
  771.     OPTIONS
  772.     -------
  773.     /R   Reverse the sort, highest sequence comes first
  774.     /+N  Sort at Column N.
  775.  
  776.     SORT sorts the input text file and writes out the sorted data.
  777.  
  778.     SORT can be used as a ~Nfilter~E program
  779.  
  780. e.g.    ~FDIR~E | SORT /R
  781. .
  782. .FRAME SUBST
  783. .TITLE Subst name of imaginary drive for path
  784.     SUBST d: [d:][\]path
  785.  
  786.     SUBST allows a pathname to be referenced as a psuedo
  787.     disk drive, allowing the use of software that can only
  788.     work with a fixed drive letter.
  789.  
  790.  
  791. .
  792. .FRAME SYS
  793. .TITLE Setup a boot disk
  794.     SYS d:
  795.  
  796.     SYS copies the system files from the default drive to
  797.         the specified drive
  798.  
  799.     The disk must have been formatted using the /S or /B option
  800.     on the FORMAT command, or the directory must be empty.
  801. .
  802. .FRAME TIME
  803. .TITLE Show/set time
  804.     TIME [hh:mm]
  805.  
  806.     TIME displays and optionally sets the system time.
  807.  
  808. .
  809. .FRAME TREE
  810. .TITLE Display subdirectory tree
  811.     TREE [d:][/F]
  812.  
  813.     If the option /F is used, the names of the files in each directory are
  814.     also listed.
  815.  
  816.     TREE displays the hierarchy of subdirectories and optionally lists
  817.     the files in each ~Nsubdirectory~E.
  818. .
  819. .FRAME TYPE
  820. .TITLE Display file on screen
  821.     TYPE [d:][\][path\]filename.filetype
  822.  
  823.     TYPE displays the textual contents of the specified file.
  824. .
  825. .FRAME VER
  826. .TITLE Give MSDOS version
  827.     VER
  828.  
  829.     This prints out the MSDOS version number, showing
  830.     the major version number and the revision level.
  831. .
  832. .FRAME VERIFY
  833. .TITLE Set disk verify On/Off
  834.     VERIFY ON or VERIFY OFF
  835.  
  836.     VERIFY ON enables disk verify operation, so that data is
  837.     chacked after it is written to the disk.
  838.  
  839.     VERIFY OFF disables the disk write verification.
  840.  
  841.     If no parameters are specified, the current setting is shown.
  842.  
  843.     VERIFY is a DOS ~Ninternal command~E
  844. .
  845. .FRAME VOL
  846. .TITLE Display disk volume label
  847.     VOL d:
  848.  
  849.     VOL displays the label of the disk on the specified drive.
  850.  
  851.     VOL is a DOS ~Ninternal command~E.
  852. .
  853. .FRAME XCOPY
  854. .TITLE Copy (extended)
  855.     XCOPY [d:][\][path\]source[d:][\][path\]destination [option[option...]]
  856.  
  857.     OPTIONS
  858.     -------
  859.     /A          Only copy files that have the Archive attribute set.
  860.     /D:dd-mm-yy Only copy files that have been changed on or after the given
  861.                 date.
  862.     /E          Copy entry subdirectories as well as ones with files in them.
  863.     /M          Only copy files that have the Archive attribute set.
  864.     /P          Confirm each copy.
  865.     /S          Copy files from both the given directory and from its subdi-
  866.                 rectories.
  867.     /V          Verify each copy as it is written, to check that the new file
  868.                 is identical to the original.
  869.     /W          Wait until a key is pressed before starting the copy.
  870.  
  871.     XCOPY provides an extended copy command that does selective copying.
  872.     ~NWildcard~E file specifications may be used.
  873. .
  874. .FRAME ECHO
  875. .TITLE Display message
  876.  
  877.     ECHO message
  878.  
  879.     ECHO displays a message to the screen from a batch file
  880.  
  881.     The forms:-
  882.  
  883.     ECHO ON
  884.  
  885.     and
  886.  
  887.     ECHO OFF
  888.  
  889.     Enable or disable the display of commands as they are executed
  890.     in a batch file. This is enabled by default.
  891.  
  892.     If no parameters are supplied, the current status is displayed.
  893. .
  894. .FRAME FOR
  895. .TITLE Operate on group of files
  896.  
  897.     FOR %%var IN wildcardspec DO command
  898.  
  899.     FOR executes the given command for each file matching the
  900.     ~NWildcard~E file specification.
  901.  
  902.     The variable var may be substituted into the command to
  903.     provide the name of the current file in the group.
  904.  
  905. e.g.    FOR %%a IN *.TXT DO TYPE %%a
  906.  
  907.     This allows all files with the extension TXT to be typed.
  908.  
  909.     This is a useful way of allowing wildcard specifications
  910.     to be used with commands that do not support them directly.
  911. .
  912. .FRAME GOTO
  913. .TITLE Branch to a label in a batch file
  914.  
  915.     GOTO label
  916.  
  917.     GOTO transfers control to a specified label in a batch
  918.     file. If the label does not exist, the batch file
  919.     aborts with an error message.
  920.  
  921. e.g.    :HERE
  922.     ECHO AGAIN
  923.     GOTO HERE
  924.  
  925.     Loops indefinately displaying the message "AGAIN"
  926. .
  927. .FRAME IF
  928. .TITLE Test a condition in batch file
  929.     IF {NOT} condition command
  930.  
  931.     If evaluates the condition, and if it is true (or false if
  932.     NOT is specified), the command is executed.
  933.  
  934.     The condition may take one of the following forms:-
  935.  
  936.     EXIST filename        This tests to see if the file exists
  937.  
  938.     ERRORLEVEL n        This tests the exit status of the previous
  939.                 command, and if it is greater than or equal
  940.                 to 'n' the condition is true
  941.  
  942.     string==string        This tests one string against another, and
  943.                 they are equal, the condition is true
  944. .
  945. .FRAME PAUSE
  946. .TITLE Await depression of key
  947.     PAUSE {remark}
  948.  
  949.     PAUSE causes the system to stop until a key is pressed
  950.     The optional remark is displayed prior to the pause, if
  951.     specified.
  952. .
  953. .FRAME REM
  954. .TITLE Remark in batch file
  955.  
  956. ---------------------  REM - Internal Batch Subcommand  -----------------------
  957.  
  958. REM denotes a remark (comment) in a batch file.
  959.  
  960. FORMAT:   REM [remark]
  961.  
  962. REMARKS:
  963.  
  964.    Remarks may be any string of characters.  The maximum length of a remark is
  965.    123 characters.  Note that remarks will not be displayed during batch file
  966.    execution if ECHO has been set to OFF.
  967.  
  968. EXAMPLE:  Display the remark, "This Batch File Backs Up the Budget Files:"
  969.  
  970.           REM This Batch File Backs Up the Budget Files
  971. .
  972. .FRAME Parameter
  973. .TITLE Supplying parameters to a batch file
  974.     Parameters
  975.  
  976.     Up to 10 parameters may be supplied to a batch file,
  977.     or more if ~FSHIFT~E is used. These parameters are
  978.     treated like ~Nenvironment variable~Es, and have the names
  979.     %0 to %9
  980.  
  981.     Environment variables set using the ~FSET~E command can be
  982.     expanded within the batch file using the notation:-
  983.  
  984.     %variablename%
  985.  
  986.     Where variablename is the ~Nenvironment variable~E.
  987. .
  988. .FRAME SHIFT
  989. .TITLE Shift arguments
  990.     SHIFT
  991.  
  992.     SHIFT moves all replaceable ~Fparameter~Es to a batch command file
  993.         down one in number, so that %1 becomes %0, %2 becomes
  994.         %1 etc. This permits more than the ten directly usable
  995.         parameters to be entered.
  996. .
  997.